home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / bbs_game / zchss17a.zip / NETCHESS.DOC < prev    next >
Text File  |  1996-03-03  |  7KB  |  161 lines
  1.  
  2.  
  3.     NETCHESS.DOC
  4.     Ver 1.7 March 1996
  5.  
  6.     Paul Fargen
  7.     6200 Richiewayne Drive
  8.     Louisville, KY
  9.  
  10.     Networking ZCHESS allows games to be played by users on different
  11.     BBSes while maintaining the games in the database of the regular
  12.     door.  This will aid in eliminating the typos and other
  13.     misunderstandings that are often a part of chess over a message
  14.     base.
  15.  
  16.     QUICK START
  17.     You will configure the required parameters for networking while you
  18.     setup subs.  Normally, the subs to be networked will be labeled
  19.     OPENxx or something similar.  If you choose to change networking for
  20.     an existing sub, you can run SETUP again, and make whatever changes
  21.     that are required.
  22.  
  23.     CONFIGURATION
  24.     Use the same SETUP.EXE to setup networked chess.  Note that the
  25.     setup program must be for version 1.7 of Zchess or greater.
  26.     This is a sample NET.CFG file that will be placed in each NETxxx
  27.     subdirectory:
  28.  
  29. Serial number for the ODD  BBS     = BBS1
  30. Serial number for the EVEN BBS     = BBS2
  31. Message subject for this section = Chess Games Open3
  32. Path to file IN box         = INBOX\
  33. Path to file OUT box         = OUTBOX\
  34. BBS software             = 1(1=SBBS, 0=Other)
  35. Convert files to messages?     = 1(1=YES, 0=NO)
  36. Path to BBS messages         = C:\SBBS
  37. Message SUB for messages     = ZCHESS
  38. Abridge output?          = 0(1=Yes,0=No)
  39.  
  40.     Serial number for the ODD  BBS:
  41.     Will be the four character registration number for the BBS which can
  42.     start the odd numbered games between the two BBSes.  The Serial
  43.     number characters are the fourth, fifth, sixth and seventh
  44.     characters of the Registration number that is in the ZCHESS.KEY file
  45.     you receive after registering.  While you are evaluating ZCHESS, you
  46.     will be using the BBS ID that is entered on the fourth line of
  47.     ZCHESS.CFG.  Note that ZCHESS requires that the first charater of
  48.     unregistered ZCHESSes to be a dash.  This maintains the uniqueness
  49.     of Registration numbers thos registering.  The entry for the ODD BBS
  50.     will be either your Serial number or that of the BBS you are sharing
  51.     files with.
  52.  
  53.     Serial number for the EVEN BBS
  54.     Same as above, except will be the registration number of the BBS
  55.     that can start the even numbered games.
  56.  
  57.     Message subject for this section
  58.     This will be used as the Subject when files are transferred between
  59.     BBSes.  When files are being retrieved by the receiving BBS from
  60.     messages, the subject of the messages in the BBS message base must
  61.     match this exactly.  This entry is case sensitive, although Zchess
  62.     will do everything in its power to maintain the format of all first
  63.     letters of words to be capitalized, with the others to be lower
  64.     case.  Note that when searching for messages that will contain the
  65.     chess moves for a sub, the To and Subject entries are compared
  66.     between this NET.CFG file and the messages.  You should limit
  67.     posting privileges on the sub to discourage sabbotage.
  68.  
  69.     Path to INBOX
  70.     Can be set to a directory for download by other BBSes calling in.
  71.     If you are using Messages, will be used for temporary storage.
  72.  
  73.     Path to OUTBOX
  74.     Can be set to an uplode directory for other BBSes calling in.
  75.     If you are using Messages, will be used for temporary storage.
  76.  
  77.     BBS Software
  78.     Can be 1 or 0.  '1' specifies that you are running SYNCHRONET BBS,
  79.     and you therefor have the opportunity to use the SBBS message base
  80.     to send games.
  81.  
  82.     Convert Files to messages?
  83.     1 = Yes, if using SBBS only.
  84.  
  85.     Path to BBS messages
  86.     Specify the DATA\SUBS directory exactly, if using SBBS.  Leave
  87.     as the default if not sending games in the messages.
  88.  
  89.     Message sub for messages
  90.     Specify an eight char sub name for a message base you wish to
  91.     use.
  92.  
  93.     Abridge Output?
  94.     There are two forms available for sending game information from a
  95.     BBS; verbose and abridged.    A typical verbose-formatted game might
  96.     look like:
  97.  
  98.         Game number     = 1
  99.         White        = Paul Fargen@FARG 1400
  100.         Black        = Jim Knight@21ST 1400
  101.         Status        = 1 (In progress)
  102.         Started        = 823242675 (02-02-96)
  103.         1.    D2-D4  D7-D5
  104.         2.    C2-C4  E7-E6
  105.         Message to White
  106.         How's the weather out there?
  107.         ---
  108.  
  109.     Each of the first five lines must be present to uniquely identify a
  110.     game.  The game numbers will be the same on both BBSes, although the
  111.     sub may differ.  The four characters after white's and black's name
  112.     represent the BBS ID for that BBS.    As stated in ZCHESS.DOC, the BBS
  113.     ID is a part of the serial number you get when registering Zchess,
  114.     which guarantees a unique ID for each BBS.    For unregistered
  115.     versions, the BBS ID is generated by the sysop using SETUP.EXE.
  116.     Zchess will force the first character to be a dash, which will
  117.     preserve the uniqueness of the registered copies, but still allow
  118.     playing.
  119.  
  120.     To save a few seconds of download time, you may set the Abridged
  121.     flag to 1 (Yes).  This will result in NETCHESS.EXE formatting the
  122.     output file as
  123.  
  124.      W=Paul Fargen@FARG 1400
  125.      B=Jim Knight@21ST 1400
  126.      T=1
  127.      S=823242675
  128.      2.  C2-C4    E7-E6
  129.      3.  B1-C3    G8-F6
  130.      4.  G1-F3    ...
  131.      w=
  132.      How's the weather out there?
  133.  
  134.     All of the information is the verbose format is contained in the
  135.     abridged, but with a reduction in byte-size.
  136.  
  137.     COMMANDLINE SWITCHES FOR NETCHESS
  138.     There are two optional switches for netchess:
  139.  
  140.     IN - Specifies that only incomming messages or files should be processed.
  141.  
  142.     OUT - Specifies that only outgoing messages or files should be processed.
  143.  
  144.     INNER WORKINGS OF NETCHESS
  145.     Netchess loops through all sections, looking for those that have
  146.     networking defined by a NET.CFG.  If games are to be sent to the other
  147.     BBS, then an ASCII file is created in your OUTBOX path.  If you are to
  148.     rely file transfers in the interBBS communications, you should define
  149.     different INBOX and OUTBOX paths for each section.    For transfers via
  150.     an SBBS message base, the INBOX and OUTBOX paths can be identical.
  151.     Netchess does a shell to the SMBUTIL.EXE program that is provided by
  152.     Digital Dynamics.  Hence, if you are running NETCHESS as an event from
  153.     SBBS without swapping to disk, you must be sure that the shell from
  154.     NETCHESS to SMBUTIL is able to allocate sufficient memory.
  155.  
  156.     You can look at the .BAT files that are created by NETCHESS to do the
  157.     importation.  The method employed relies heavily on DOS redirection.
  158.     Command files are created that are redirected into SMBUTIL which allows
  159.     use of that normally interractive program as an unattended utility.
  160.  
  161.